Page-Range Information(IM:XP)

Page-Range Information
The collection item ID for page-range information is defined in the following enumeration:
enum { gxPageRangeTag = 'rang' };   
QuickDraw GX stores page-range information in the gxPageRangeInfo structure:
struct gxPageRangeInfo {
   gxSimplePageRangeInfo   simpleRange;   
   Str31                   fromString;    
   Str31                   toString;      
   long                    minFromPage;   
   long                    maxToPage;     
   char                    replaceString[1]; 
};
Field Description

simpleRange
A string containing the page-range information structure.
fromString
A string containing the beginning of a user-specified custom page range.
toString
A string containing the end of a user-specified custom page range.
minFromPage
The minimum default page range.
maxToPage
The maximum default page range.
replaceString
A string containing the user-specified page range from the Print dialog box. Initially, the string is one character long.
QuickDraw GX stores simple page-range information in the gxSimplePageRangeInfo structure:
struct gxSimplePageRangeInfo {
   char     optionChosen;  
   Boolean  printAll;       
   long     fromPage;      
   long     toPage;        
};
Field Description

optionChosen
A character that contains the specific page-range option (either the default page range, replacement page range, or customized page range).
printAll
A Boolean value indicating whether the user wants to print all of the pages in a single document. When the user chooses the All radio button in the Print dialog box, the printAll field contains true; otherwise, the field contains false.
fromPage
The first page in the page range to print. The user specifies a page range to print in the Print dialog box.
toPage
The last page in the page range to print. The user specifies a page range to print in the Print dialog box.
QuickDraw GX defines page-range options in the following enumeration:
enum {
   gxDefaultPageRange   = (char) 0, 
   gxReplacePageRange   = (char) 1, 
   gxCustomizePageRange = (char) 2  
};
Constant descriptions

gxDefaultPageRange
If set, QuickDraw GX uses a standard numeric page range; for example, the From field of the Print dialog box contains 1 and the To field contains 4.
gxReplacePageRange
If set, QuickDraw GX uses a single editable text field that specifies a page range; for example, a field with "Chapter 5" as the contents.
gxCustomizePageRange
If set, QuickDraw GX allows alphanumeric values for the From and To fields in the Print dialog box. You are responsible for validation of these values.

Main | Page One | What's New | Apple Computer, Inc. | Find It | Contact Us | Help